Summary

Bead: av-vwa.16.7

User decision implemented: the public canonical AgentV trace artifact now uses schema_version: "agentv.trace.v1". This replaces the just-merged agentv.execution_trace.v1 namespace without broad compatibility aliases.

The existing normalized trajectory/read-model namespace no longer claims agentv.trace.v1. That derived projection now uses agentv.trajectory.v1, so there is one trace-ish public canonical namespace: agentv.trace.v1.

Namespace Changes

• Canonical execution trace sidecar: agentv.execution_trace.v1 -> agentv.trace.v1
• Derived trajectory/read-model projection: agentv.trace.v1 -> agentv.trajectory.v1
• No agentv.execution_trace.v1 or agentv.trace_envelope.v1 readers/writers/aliases were added
• Kept existing PR feat(trace): settle canonical trace projection #1401 choices that do not conflict:
  • replay config key remains execution_traces
  • sidecar path remains outputs/execution-trace.json
  • traceEnvelopeToMessages() remains the replay provider projection
  • traceEnvelopeToTranscriptMessages() remains the transcript sidecar projection

Red/Green UAT

Red on origin/main:

bun --filter @agentv/core build
rm -rf /tmp/agentv-trace-v1-red
bun apps/cli/src/cli.ts eval examples/showcase/trace-evaluation/evals/coding-agent-replay.eval.yaml --target replay_coding_agent --output /tmp/agentv-trace-v1-red

Result:

• Replay eval passed: 2/2
• Generated outputs/execution-trace.json sidecars used schema_version: "agentv.execution_trace.v1"
• Old namespace count: 2
• Canonical agentv.trace.v1 count: 0
• Transcript sidecars preserved rows: user,assistant,assistant

Green on this branch:

bun --filter @agentv/core build
bun --filter @agentv/eval build
rm -rf /tmp/agentv-trace-v1-uat
bun apps/cli/src/cli.ts eval examples/showcase/trace-evaluation/evals/coding-agent-replay.eval.yaml --target replay_coding_agent --output /tmp/agentv-trace-v1-uat

Result:

• Replay eval passed: 2/2
• Generated outputs/execution-trace.json sidecars use schema_version: "agentv.trace.v1"
• Old namespace count: 0
• Canonical agentv.trace.v1 count: 2
• Transcript sidecars preserved rows: user,assistant,assistant

Verification

bun test packages/core/test/evaluation/trace-envelope.test.ts apps/cli/test/commands/eval/artifact-writer.test.ts packages/core/test/evaluation/replay-fixtures.test.ts packages/core/test/evaluation/trace-summary.test.ts packages/core/test/evaluation/trace-trajectory.test.ts apps/cli/test/commands/trace/trace.test.ts packages/eval/test/define-code-grader.test.ts packages/eval/test/define-prompt-template.test.ts
bun run lint
bun run typecheck
bun --filter @agentv/core build
bun --filter @agentv/eval build
bun run test

Results:

• Focused tests passed: 179 pass, 0 fail
• bun run lint passed
• bun run typecheck passed
• bun --filter @agentv/core build passed
• bun --filter @agentv/eval build passed
• Full bun run test passed across core, eval, phoenix-adapter, CLI, and dashboard packages

Additional source scan:

rg -n "agentv\\.execution_trace\\.v1|agentv\\.trace_envelope\\.v1" . -g '!node_modules' -g '!dist' -g '!*.lockb'

Result: no matches.